home *** CD-ROM | disk | FTP | other *** search
/ Compendium Deluxe 1 / LSD Compendium Deluxe 1.iso / a / programming / misc / srev142.lha / SetRev142 / SetRev142.doc < prev    next >
Encoding:
Text File  |  1994-01-16  |  3.8 KB  |  118 lines
  1. TABLE OF CONTENTS
  2.  
  3. SetRev
  4. SetRev                                                               SetRev
  5.  
  6.    COPYRIGHT
  7.   SetRev is *COPYRIGHT* (C) by Alexander Sieb in 1992-1994.
  8.  
  9.    LICENSE
  10.   This program is free software; you can redistribute it and/or modify
  11.   it under the terms of the GNU General Public License as published by
  12.   the Free Software Foundation; either version 2 of the License, or
  13.   (at your option) any later version.
  14.  
  15.   This program is distributed in the hope that it will be useful,
  16.   but WITHOUT ANY WARRANTY; without even the implied warranty of
  17.   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  18.   GNU General Public License for more details.
  19.  
  20.   You should have received a copy of the GNU General Public License
  21.   along with this program; if not, write to the Free Software
  22.   Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
  23.  
  24.    NAME
  25.   SetRev v1.42 - An update of SetRev v1.41 - Requires V37
  26.  
  27.    SYNOPSIS
  28.   SetRev - A tool to automatically handle version and revision of your
  29.   program.
  30.  
  31.    FUNCTION
  32.   SetRev will create a revision file stamp that indicates your current
  33.   revision. With each call your revision is increased by one and three
  34.   files are generated. A C header file, an ASM header file and an ANSI
  35.   C source file. In these files several information about version,
  36.   revision, date and time at compilation time of your program is saved.
  37.   With these files you can easily the development state of your work, 
  38.   version can be recognized by its version and revision number.
  39.  
  40.    INPUTS
  41.   The SetRev options are as follows:
  42.  
  43.   VER/N/A        - Indicates the current version of your product.
  44.  
  45.   FILE/A         - This is the file where the revision stamp is saved to.
  46.                    Each call of setrev increases the revsions by one.
  47.                    SetRev automatically adds the suffix '.rev' to the file.
  48.                    If the project name is CEK i recommend to name the file:
  49.                    CEK_REV or CEK_REV.rev.
  50.  
  51.   REV/N/K        - This sets the revision to a given number. Don't use this
  52.                    in makefiles, because SetRev won't increase the revsion.
  53.  
  54.   OBJ/K          - Defines your project name. This is set by default to
  55.                    FILE/A without its suffix, but with its full path.
  56.  
  57.   QUIET/S        - This switches the standard terminal output off.
  58.  
  59.   DEP/K          - Defines a file that is looked for each call. If DEP/K is
  60.                    newer than FILE/A the revision is increased. In any other
  61.                    case all is left as it is.
  62.  
  63.   SHOWREV/S      - This prevents SetRev from printing all messages except
  64.                    error messages and the new revision.
  65.  
  66.   NOASM/S        - This switches ASM header file creation off.
  67.  
  68.   NOC/S          - This switches C header file creation off.
  69.  
  70.   NOANSI/S       - This switches ANSI C source file creation off.
  71.  
  72.  
  73.  
  74.    RESULTS
  75.  Four files are created by default:  FILE.rev, FILE.c, FILE.h and FILE.i.
  76.  The contents are as follows:
  77.  
  78.    /* C Headerfile created by SetRev 1.42 */
  79.  
  80.    #define VERSION 1
  81.    #define REVISION 11 
  82.    #define DATE "01.08.93"
  83.    #define VERS "t:t 1.11"
  84.    #define VSTRING "t:t 1.11 (01.08.93)\n\r" 
  85.    #define VSTRING2 "t:t 1.11 (01.08.93)"
  86.    #define VERSTAG "\0$VER: t:t 1.11 (01.08.93)"
  87.  
  88.    /* ANSI C file created by SetRev 1.42 */
  89.  
  90.    const unsigned long Version = 1;
  91.    const unsigned long Revision = 8;
  92.    const unsigned char CreationDate[] = {"01.08.93"};
  93.    const unsigned char CreationTime[] = {"14:08:24"};
  94.    const unsigned char VersionTag[] = {"\0$VER: t:T 1.8 (01.08.93)"};
  95.  
  96.    ; ASM Headerfile created by SetRev 1.42
  97.  
  98.    VERSION        EQU    1
  99.    REVISION    EQU    11
  100.    DATE     MACRO
  101.         dc.b    '01.08.93'
  102.       ENDM
  103.    VERS     MACRO
  104.         dc.b    't:t 1.11'
  105.      ENDM
  106.    VSTRING    MACRO
  107.         dc.b    't:t 1.11 (01.08.93)',13,10,0
  108.       ENDM
  109.    VSTRING2    MACRO
  110.         dc.b    't:t 1.11 (01.08.93)',0
  111.      ENDM
  112.    VERSTAG    MACRO
  113.         dc.b    0,'$VER: t:t 1.11 (01.08.93)',0
  114.      ENDM
  115.  
  116.    BUGS
  117.   NONE ?
  118.